---
sidebar_position: 1
---

# Инструкция по установке

## Поддерживаемые платформы

- Windows 10/11 AMD64/ARM64
- MacOS 10.15+ AMD64 for development, MacOS 10.13+ for release
- MacOS 11.0+ ARM64
- Linux AMD64/ARM64

## Зависимости

Wails имеет ряд общих зависимостей, которые необходимы перед установкой:

- Go 1.21+ (macOS 15+ requires Go 1.23.3+)
- NPM (Node 15+)

### Go

Скачайте Go с [Go Downloads Page](https://go.dev/dl/).

Убедитесь, что вы следуете официальным [Инструкциям по установке](https://go.dev/doc/install). Вам также нужно убедиться, что ваша переменная окружения `PATH` также включает путь к вашему каталогу `~/go/bin`. Перезапустите терминал и выполните следующие шаги:

- Проверьте то, что Go установлен правильно: `go version`
- Проверьте "~/go/bin" в переменной PATH: `echo $PATH | grep go/bin`

### NPM

Загрузите NPM отсюда: [Node Downloads Page](https://nodejs.org/en/download/). Лучше использовать последнюю версию, так как это то, что мы её обычно тестируем.

Запустите `npm --version` для проверки.

## Зависимости платформы

Вам также нужно установить специфичные для платформы зависимости:

```mdx-code-block
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";

<Tabs
  defaultValue="Windows"
  values={[
    { label: "Windows", value: "Windows" },
    { label: "MacOS", value: "MacOS" },
    { label: "Linux", value: "Linux" },
  ]}
>
  <TabItem value="MacOS">
    Wails требует установки инструментов xcode command line tools. Их можно установить,
    запустив <code>xcode-select --install</code>.
  </TabItem>
  <TabItem value="Windows">
    Wails требует установки <a href="https://developer.microsoft.com/en-us/microsoft-edge/webview2/">WebView2</a>. В некоторых установках Windows это уже установлено. Вы можете проверить используя команду <code>wails doctor</code>.
  </TabItem>
  <TabItem value={"Linux"}>
    Linux requires the standard <code>gcc</code> build tools plus <code>libgtk3</code> and <code>libwebkit</code>. Вместо того чтобы перечислять огромное количество команд для разных дистрибутивов, Wails может попробовать определить команды установки, специфичные для вашего дистрибутива. Запустите <code>wails doctor</code> после установки, чтобы узнать, как установить зависимости. Если ваш дистрибутив или менеджер пакетов не поддерживается, пожалуйста, обратитесь к руководству {" "} <a href={"/docs/guides/linux-distro-support"}>Добавление дистрибутива Linux</a>.
    <br/><strong>Note:</strong><br/>
    If you are using latest Linux version (example: Ubuntu 24.04) and it is not supporting <code>libwebkit2gtk-4.0-dev</code>, then you might encounter an issue in <code>wails doctor</code>: <code>libwebkit</code> not found. To resolve this issue you can install <code>libwebkit2gtk-4.1-dev</code> and during your build use the tag <code>-tags webkit2_41</code>.
  </TabItem>
</Tabs>
```

## Необязательные зависимости

- [UPX](https://upx.github.io/) для сжатия приложений.
- [NSIS](https://wails.io/docs/guides/windows-installer/) for generating Windows installers.

## Установка Wails

Выполните `go install github.com/wailsapp/wails/v2/cmd/wails@latest` для установки Wails CLI.

Примечание: Если вы получите ошибку, похожую на эту:

```shell
....\Go\pkg\mod\github.com\wailsapp\wails\v2@v2.1.0\pkg\templates\templates.go:28:12: pattern all:ides/*: no matching files found
```
пожалуйста, убедитесь, что у вас установлен Go 1.18+:
```shell
go version
```

## Проверка системы

Запуск `wails doctor` проверит установлены ли у вас правильные зависимости. Если нет, то он покажет что не хватает, и покажет как исправить какие-либо проблемы.

## Отсутствует команда `wails`?

Если ваша система пишет, что команда `wails` отсутствует, удостоверьтесь, что вы корректно следовали инструкции по установке Go. Обычно это значит, что папка `go/bin`, находящаяся в домашней папке пользователя не добавлена в переменную окружения `PATH`. Обычно после изменения переменных окружения нужно переоткрыть командную строку, чтобы изменения применились в ней.
